home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmForm.z / XmForm
Encoding:
Text File  |  2002-10-03  |  66.0 KB  |  925 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmFFFFoooorrrrmmmm - The Form widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////FFFFoooorrrrmmmm....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           Form is a container widget with no input semantics of its
  20.           own.  Constraints are placed on children of the Form to
  21.           define attachments for each of the child's four sides.
  22.           These attachments can be to the Form, to another child
  23.           widget or gadget, to a relative position within the Form, or
  24.           to the initial position of the child.  The attachments
  25.           determine the layout behavior of the Form when resizing
  26.           occurs.
  27.  
  28.           The default value for XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is the value of
  29.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn.
  30.  
  31.           Following are some important considerations in using a Form:
  32.  
  33.  
  34.             +o  Every child must have an attachment on either the left
  35.                or the right.  If initialization or XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss leaves
  36.                a widget without such an attachment, the result depends
  37.                upon the value of XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg.
  38.  
  39.                If XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg is False, the child is given an
  40.                XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM and an XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt
  41.                equal to its current _x value.
  42.  
  43.                If XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg is True, the child is given an
  44.                XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN and an
  45.                XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn proportional to the current _x value
  46.                divided by the width of the Form.
  47.  
  48.                In either case, if the child has not been previously
  49.                given an _x value, its _x value is taken to be 0, which
  50.                places the child at the left side of the Form.
  51.  
  52.             +o  If you want to create a child without any attachments,
  53.                and then later (e.g., after creating and managing it,
  54.                but before realizing it) give it a right attachment via
  55.                XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss, you must set its XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt to
  56.                XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE at the same time.
  57.  
  58.             +o  The XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee resource controls only whether a
  59.                geometry request by the child will be granted.  It has
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                no effect on whether the child's size can be changed
  75.                because of changes in geometry of the Form or of other
  76.                children.
  77.  
  78.             +o  Every child has a preferred width, based on geometry
  79.                requests it makes (whether they are granted or not).
  80.  
  81.             +o  If a child has attachments on both the left and the
  82.                right sides, its size is completely controlled by the
  83.                Form.  It can be shrunk below its preferred width or
  84.                enlarged above it, if necessary, due to other
  85.                constraints.  In addition, the child's geometry
  86.                requests to change its own width may be refused.
  87.  
  88.             +o  If a child has attachments on only its left or right
  89.                side, it will always be at its preferred width (if
  90.                resizable, otherwise at is current width).  This may
  91.                cause it to be clipped by the Form or by other
  92.                children.
  93.  
  94.             +o  If a child's left (or right) attachment is set to
  95.                XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF, its corresponding left (or right) offset
  96.                is forced to 0.  The attachment is then changed to
  97.                XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, with a position that corresponds to
  98.                _x value of the child's left (or right) edge.  To fix
  99.                the position of a side at a specific _x value use
  100.                XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM with the _x
  101.                value as the left (or right) offset.
  102.  
  103.             +o  Unmapping a child has no effect on the Form except that
  104.                the child is not mapped.
  105.  
  106.             +o  Unmanaging a child unmaps it.  If no other child is
  107.                attached to it, or if all children attached to it and
  108.                all children recursively attached to them are also all
  109.                unmanaged, all of those children are treated as if they
  110.                did not exist in determining the size of the Form.
  111.  
  112.             +o  When using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss to change the XXXXmmmmNNNNxxxx resource of a
  113.                child, you must simultaneously set its left attachment
  114.                to either XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE.  Otherwise,
  115.                the request is not granted.  If XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee is False,
  116.                the request is granted only if the child's size can
  117.                remain the same.
  118.  
  119.             +o  A left (or right) attachment of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT, where
  120.                XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt (or XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt) is NULL, acts like an
  121.                attachment of XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM.
  122.  
  123.             +o  If an attachment is made to a widget that is not a
  124.                child of the Form, but an ancestor of the widget is a
  125.                child of the Form, the attachment is made to the
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                ancestor.
  141.  
  142.  
  143.           All these considerations are true of top and bottom
  144.           attachments as well, with top acting like left, bottom
  145.           acting like right, _y acting like _x, and height acting like
  146.           width.
  147.  
  148.         CCCCllllaaaasssssssseeeessss
  149.           Form inherits behavior and resources from CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee,
  150.           CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd classes.
  151.  
  152.           The class pointer is xxxxmmmmFFFFoooorrrrmmmmWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  153.  
  154.           The class name is XXXXmmmmFFFFoooorrrrmmmm.
  155.  
  156.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  157.           The following table defines a set of widget resources used
  158.           by the programmer to specify data.  The programmer can also
  159.           set the resource values for the inherited classes to set
  160.           attributes for this widget.  To reference a resource by name
  161.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  162.           prefix and use the remaining letters.  To specify one of the
  163.           defined values for a resource in a .Xdefaults file, remove
  164.           the XXXXmmmm prefix and use the remaining letters (in either
  165.           lowercase or uppercase, but include any underscores between
  166.           words).  The codes in the access column indicate if the
  167.           given resource can be set at creation time (C), set by using
  168.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  169.           not applicable (N/A).
  170.  
  171.                                 XXXXmmmmFFFFoooorrrrmmmm RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  172.      NNNNaaaammmmeeee                   CCCCllllaaaassssssss                  TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  173.      __________________________________________________________________________
  174.      XmNfractionBase        XmCMaxValue            int         100       CSG
  175.      XmNhorizontalSpacing   XmCSpacing             Dimension   0         CSG
  176.      XmNrubberPositioning   XmCRubberPositioning   Boolean     False     CSG
  177.      XmNverticalSpacing     XmCSpacing             Dimension   0         CSG
  178.  
  179.  
  180.           XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  181.                     Specifies the denominator used in calculating the
  182.                     relative position of a child widget using
  183.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN constraints.  The value must not
  184.                     be 0.
  185.  
  186.                     If the value of a child's XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt (or
  187.                     XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt) is XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, the
  188.                     position of the left (or right) side of the child
  189.                     is relative to the left side of the Form and is a
  190.                     fraction of the width of the Form.  This fraction
  191.                     is the value of the child's XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn (or
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn) resource divided by the value of
  207.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.
  208.  
  209.                     If the value of a child's XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt (or
  210.                     XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt) is XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN, the
  211.                     position of the top (or bottom) side of the child
  212.                     is relative to the top side of the Form and is a
  213.                     fraction of the height of the Form.  This fraction
  214.                     is the value of the child's XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn (or
  215.                     XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn) resource divided by the value
  216.                     of the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.
  217.  
  218.           XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllSSSSppppaaaacccciiiinnnngggg
  219.                     Specifies the offset for right and left
  220.                     attachments.  This resource is only used if no
  221.                     offset resource is specified (when attaching to a
  222.                     widget), or if no margin resource is specified
  223.                     (when attaching to the Form).
  224.  
  225.           XXXXmmmmNNNNrrrruuuubbbbbbbbeeeerrrrPPPPoooossssiiiittttiiiioooonnnniiiinnnngggg
  226.                     Indicates the default near (left) and top
  227.                     attachments for a child of the Form.  (NNNNooootttteeee::::
  228.                     Whether this resource actually applies to the left
  229.                     or right side of the child and its attachment may
  230.                     depend on the value of the XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  231.                     resource.)
  232.  
  233.                     The default left attachment is applied whenever
  234.                     initialization or XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss leaves the child
  235.                     without either a left or right attachment.  The
  236.                     default top attachment is applied whenever
  237.                     initialization or XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss leaves the child
  238.                     without either a top or bottom attachment.
  239.  
  240.                     If this Boolean resource is set to False,
  241.                     XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt and XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt default to
  242.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM, XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt defaults to the
  243.                     current _x value of the left side of the child, and
  244.                     XXXXmmmmNNNNttttooooppppOOOOffffffffsssseeeetttt defaults to the current _y value of
  245.                     the child.  The effect is to position the child
  246.                     according to its absolute distance from the left
  247.                     or top side of the Form.
  248.  
  249.                     If this resource is set to True, XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  250.                     and XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt default to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN,
  251.                     XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn defaults to a value proportional
  252.                     to the current _x value of the left side of the
  253.                     child divided by the width of the Form, and
  254.                     XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn defaults to a value proportional to
  255.                     the current _y value of the child divided by the
  256.                     height of the Form.  The effect is to position the
  257.                     child relative to the left or top side of the Form
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     and in proportion to the width or height of the
  273.                     Form.
  274.  
  275.           XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllSSSSppppaaaacccciiiinnnngggg
  276.                     Specifies the offset for top and bottom
  277.                     attachments.  This resource is only used if no
  278.                     offset resource is specified (when attaching to a
  279.                     widget), or if no margin resource is specified
  280.                     (when attaching to the Form).
  281.  
  282.                               XXXXmmmmFFFFoooorrrrmmmm CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  283.        NNNNaaaammmmeeee                  CCCCllllaaaassssssss           TTTTyyyyppppeeee            DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
  284.        ____________________________________________________________________________
  285.        XmNbottomAttachment   XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  286.        XmNbottomOffset       XmCOffset       int             0               CSG
  287.        XmNbottomPosition     XmCAttachment   int             0               CSG
  288.        XmNbottomWidget       XmCWidget       Widget          NULL            CSG
  289.        XmNleftAttachment     XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  290.        XmNleftOffset         XmCOffset       int             0               CSG
  291.        XmNleftPosition       XmCAttachment   int             0               CSG
  292.        XmNleftWidget         XmCWidget       Widget          NULL            CSG
  293.        XmNresizable          XmCBoolean      Boolean         True            CSG
  294.        XmNrightAttachment    XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  295.        XmNrightOffset        XmCOffset       int             0               CSG
  296.        XmNrightPosition      XmCAttachment   int             0               CSG
  297.        XmNrightWidget        XmCWidget       Widget          NULL            CSG
  298.        XmNtopAttachment      XmCAttachment   unsigned char   XmATTACH_NONE   CSG
  299.        XmNtopOffset          XmCOffset       int             0               CSG
  300.        XmNtopPosition        XmCAttachment   int             0               CSG
  301.        XmNtopWidget          XmCWidget       Widget          NULL            CSG
  302.  
  303.           XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  304.                     Specifies attachment of the bottom side of the
  305.                     child.  It can have the following values:
  306.  
  307.  
  308.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE-Do not attach the bottom side
  309.                          of the child.
  310.  
  311.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM-Attach the bottom side of the
  312.                          child to the bottom side of the Form.
  313.  
  314.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM-Attach the bottom side
  315.                          of the child to the top side of the Form.
  316.                          XXXXmmmmNNNNbbbboooottttttttoooommmmOOOOffffffffsssseeeetttt can be used to determine the
  317.                          visibility of the child.
  318.  
  319.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT-Attach the bottom side of the
  320.                          child to the top side of the widget or gadget
  321.                          specified in the XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt resource.
  322.                          If XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt is NULL, XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  323.                          is replaced by XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM, and the child
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                          is attached to the bottom side of the Form.
  339.  
  340.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT-Attach the bottom
  341.                          side of the child to the bottom side of the
  342.                          widget or gadget specified in the
  343.                          XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt resource.
  344.  
  345.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN-Attach the bottom side of
  346.                          the child to a position that is relative to
  347.                          the top side of the Form and in proportion to
  348.                          the height of the Form.  This position is
  349.                          determined by the XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn and
  350.                          XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  351.  
  352.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF-Attach the bottom side of the
  353.                          child to a position that is proportional to
  354.                          the current _y value of the bottom of the
  355.                          child divided by the height of the Form.
  356.                          This position is determined by the
  357.                          XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  358.                          resources.  XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn is set to a
  359.                          value proportional to the current _y value of
  360.                          the bottom of the child divided by the height
  361.                          of the Form.
  362.  
  363.  
  364.           XXXXmmmmNNNNbbbboooottttttttoooommmmOOOOffffffffsssseeeetttt
  365.                     Specifies the constant offset between the bottom
  366.                     side of the child and the object to which it is
  367.                     attached.  The relationship established remains,
  368.                     regardless of any resizing operations that occur.
  369.                     When this resource is explicitly set, the value of
  370.                     XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllSSSSppppaaaacccciiiinnnngggg is ignored.
  371.  
  372.           XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn
  373.                     This resource is used to determine the position of
  374.                     the bottom side of the child when the child's
  375.                     XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.
  376.                     In this case the position of the bottom side of
  377.                     the child is relative to the top side of the Form
  378.                     and is a fraction of the height of the Form.  This
  379.                     fraction is the value of the child's
  380.                     XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn resource divided by the value of
  381.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  382.                     child's XXXXmmmmNNNNbbbboooottttttttoooommmmPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  383.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's height is
  384.                     200, the position of the bottom side of the child
  385.                     is 100.
  386.  
  387.           XXXXmmmmNNNNbbbboooottttttttoooommmmWWWWiiiiddddggggeeeetttt
  388.                     Specifies the widget or gadget to which the bottom
  389.                     side of the child is attached.  This resource is
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     used if XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to either
  405.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  406.  
  407.                     A string-to-widget resource converter is
  408.                     automatically installed for use with this
  409.                     resource.  With this converter, the widget that is
  410.                     to be the value of the resource must exist at the
  411.                     time the widget that has the resource is created.
  412.  
  413.           XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  414.                     Specifies attachment of the near (left) side of
  415.                     the child.  (NNNNooootttteeee::::  Whether this resource actually
  416.                     applies to the left or right side of the child and
  417.                     its attachment may depend on the value of the
  418.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  It can have the
  419.                     following values:
  420.  
  421.  
  422.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE-Do not attach the left side of
  423.                          the child.  If XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is also
  424.                          XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE, this value is ignored and the
  425.                          child is given a default left attachment.
  426.  
  427.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM-Attach the left side of the
  428.                          child to the left side of the Form.
  429.  
  430.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM-Attach the left side
  431.                          of the child to the right side of the Form.
  432.                          XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt can be used to determine the
  433.                          visibility of the child.
  434.  
  435.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT-Attach the left side of the
  436.                          child to the right side of the widget or
  437.                          gadget specified in the XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt
  438.                          resource.  If XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt is NULL,
  439.                          XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT is replaced by XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM,
  440.                          and the child is attached to the left side of
  441.                          the Form.
  442.  
  443.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT-Attach the left side
  444.                          of the child to the left side of the widget
  445.                          or gadget specified in the XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt
  446.                          resource.
  447.  
  448.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN-Attach the left side of the
  449.                          child to a position that is relative to the
  450.                          left side of the Form and in proportion to
  451.                          the width of the Form.  This position is
  452.                          determined by the XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn and
  453.                          XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  454.  
  455.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF-Attach the left side of the
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                          child to a position that is proportional to
  471.                          the current _x value of the left side of the
  472.                          child divided by the width of the Form.  This
  473.                          position is determined by the XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn
  474.                          and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  475.                          XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn is set to a value
  476.                          proportional to the current _x value of the
  477.                          left side of the child divided by the width
  478.                          of the Form.
  479.  
  480.  
  481.           XXXXmmmmNNNNlllleeeeffffttttOOOOffffffffsssseeeetttt
  482.                     Specifies the constant offset between the near
  483.                     (left) side of the child and the object to which
  484.                     it is attached.  (NNNNooootttteeee::::  Whether this resource
  485.                     actually applies to the left or right side of the
  486.                     child and its attachment may depend on the value
  487.                     of the XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  The
  488.                     relationship established remains, regardless of
  489.                     any resizing operations that occur.  When this
  490.                     resource is explicitly set, the value of
  491.                     XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllSSSSppppaaaacccciiiinnnngggg is ignored.
  492.  
  493.           XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn
  494.                     This resource is used to determine the position of
  495.                     the near (left) side of the child when the child's
  496.                     XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.
  497.                     (NNNNooootttteeee::::  Whether this resource actually applies to
  498.                     the left or right side of the child and its
  499.                     attachment may depend on the value of the
  500.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)
  501.  
  502.                     In this case the position of the left side of the
  503.                     child is relative to the left side of the Form and
  504.                     is a fraction of the width of the Form.  This
  505.                     fraction is the value of the child's
  506.                     XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn resource divided by the value of
  507.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  508.                     child's XXXXmmmmNNNNlllleeeeffffttttPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  509.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's width is
  510.                     200, the position of the left side of the child is
  511.                     100.
  512.  
  513.           XXXXmmmmNNNNlllleeeeffffttttWWWWiiiiddddggggeeeetttt
  514.                     Specifies the widget or gadget to which the near
  515.                     (left) side of the child is attached.  (NNNNooootttteeee::::
  516.                     Whether this resource actually applies to the left
  517.                     or right side of the child and its attachment may
  518.                     depend on the value of the XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  519.                     resource.)  This resource is used if
  520.                     XXXXmmmmNNNNlllleeeeffffttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to either XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT
  521.                     or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                     A string-to-widget resource converter is
  537.                     automatically installed for use with this
  538.                     resource.  With this converter, the widget that is
  539.                     to be the value of the resource must exist at the
  540.                     time the widget that has the resource is created.
  541.  
  542.           XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee
  543.                     This Boolean resource specifies whether or not a
  544.                     child's request for a new size is (conditionally)
  545.                     granted by the Form.  If this resource is set to
  546.                     True the request is granted if possible.  If this
  547.                     resource is set to False the request is always
  548.                     refused.
  549.  
  550.                     If a child has both left and right attachments,
  551.                     its width is completely controlled by the Form,
  552.                     regardless of the value of the child's
  553.                     XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee resource.  If a child has a left or
  554.                     right attachment but not both, the child's
  555.                     XXXXmmmmNNNNwwwwiiiiddddtttthhhh is used in setting its width if the value
  556.                     of the child's XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee resource is True.
  557.                     These conditions are also true for top and bottom
  558.                     attachments, with height acting like width.
  559.  
  560.           XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  561.                     Specifies attachment of the far (right) side of
  562.                     the child.  (NNNNooootttteeee::::  Whether this resource actually
  563.                     applies to the left or right side of the child and
  564.                     its attachment may depend on the value of the
  565.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  It can have the
  566.                     following values:
  567.  
  568.  
  569.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE-Do not attach the right side of
  570.                          the child.
  571.  
  572.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM-Attach the right side of the
  573.                          child to the right side of the Form.
  574.  
  575.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM-Attach the right side
  576.                          of the child to the left side of the Form.
  577.                          XXXXmmmmNNNNrrrriiiigggghhhhttttOOOOffffffffsssseeeetttt can be used to determine the
  578.                          visibility of the child.
  579.  
  580.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT-Attach the right side of the
  581.                          child to the left side of the widget or
  582.                          gadget specified in the XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt
  583.                          resource.  If XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt is NULL,
  584.                          XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT is replaced by XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM,
  585.                          and the child is attached to the right side
  586.                          of the Form.
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  599.  
  600.  
  601.  
  602.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT-Attach the right
  603.                          side of the child to the right side of the
  604.                          widget or gadget specified in the
  605.                          XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt resource.
  606.  
  607.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN-Attach the right side of
  608.                          the child to a position that is relative to
  609.                          the left side of the Form and in proportion
  610.                          to the width of the Form.  This position is
  611.                          determined by the XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn and
  612.                          XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  613.  
  614.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF-Attach the right side of the
  615.                          child to a position that is proportional to
  616.                          the current _x value of the right side of the
  617.                          child divided by the width of the Form.  This
  618.                          position is determined by the
  619.                          XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn and XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee
  620.                          resources.  XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn is set to a
  621.                          value proportional to the current _x value of
  622.                          the right side of the child divided by the
  623.                          width of the Form.
  624.  
  625.  
  626.           XXXXmmmmNNNNrrrriiiigggghhhhttttOOOOffffffffsssseeeetttt
  627.                     Specifies the constant offset between the far
  628.                     (right) side of the child and the object to which
  629.                     it is attached.  (NNNNooootttteeee::::  Whether this resource
  630.                     actually applies to the left or right side of the
  631.                     child and its attachment may depend on the value
  632.                     of the XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)  The
  633.                     relationship established remains, regardless of
  634.                     any resizing operations that occur.  When this
  635.                     resource is explicitly set, the value of
  636.                     XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllSSSSppppaaaacccciiiinnnngggg is ignored.
  637.  
  638.           XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn
  639.                     This resource is used to determine the position of
  640.                     the far (right) side of the child when the child's
  641.                     XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.
  642.                     (NNNNooootttteeee::::  Whether this resource actually applies to
  643.                     the left or right side of the child and its
  644.                     attachment may depend on the value of the
  645.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.)
  646.  
  647.                     In this case the position of the right side of the
  648.                     child is relative to the left side of the Form and
  649.                     is a fraction of the width of the Form.  This
  650.                     fraction is the value of the child's
  651.                     XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn resource divided by the value of
  652.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  653.                     child's XXXXmmmmNNNNrrrriiiigggghhhhttttPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 4/30/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  665.  
  666.  
  667.  
  668.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's width is
  669.                     200, the position of the right side of the child
  670.                     is 100.
  671.  
  672.           XXXXmmmmNNNNrrrriiiigggghhhhttttWWWWiiiiddddggggeeeetttt
  673.                     Specifies the widget or gadget to which the far
  674.                     (right) side of the child is attached.  (NNNNooootttteeee::::
  675.                     Whether this resource actually applies to the left
  676.                     or right side of the child and its attachment may
  677.                     depend on the value of the XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  678.                     resource.)  This resource is used if
  679.                     XXXXmmmmNNNNrrrriiiigggghhhhttttAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to either
  680.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  681.  
  682.                     A string-to-widget resource converter is
  683.                     automatically installed for use with this
  684.                     resource.  With this converter, the widget that is
  685.                     to be the value of the resource must exist at the
  686.                     time the widget that has the resource is created.
  687.  
  688.           XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt
  689.                     Specifies attachment of the top side of the child.
  690.                     It can have following values:
  691.  
  692.  
  693.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE-Do not attach the top side of
  694.                          the child.  If XXXXmmmmNNNNbbbboooottttttttoooommmmAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is also
  695.                          XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____NNNNOOOONNNNEEEE, this value is ignored and the
  696.                          child is given a default top attachment.
  697.  
  698.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM-Attach the top side of the
  699.                          child to the top side of the Form.
  700.  
  701.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____FFFFOOOORRRRMMMM-Attach the top side of
  702.                          the child to the bottom side of the Form.
  703.                          XXXXmmmmNNNNttttooooppppOOOOffffffffsssseeeetttt can be used to determine the
  704.                          visibility of the child.
  705.  
  706.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT-Attach the top side of the
  707.                          child to the bottom side of the widget or
  708.                          gadget specified in the XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt
  709.                          resource.  If XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt is NULL,
  710.                          XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT is replaced by XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____FFFFOOOORRRRMMMM,
  711.                          and the child is attached to the top side of
  712.                          the Form.
  713.  
  714.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT-Attach the top side
  715.                          of the child to the top side of the widget or
  716.                          gadget specified in the XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt
  717.                          resource.
  718.  
  719.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN-Attach the top side of the
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 4/30/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  731.  
  732.  
  733.  
  734.                          child to a position that is relative to the
  735.                          top side of the Form and in proportion to the
  736.                          height of the Form.  This position is
  737.                          determined by the XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn and
  738.                          XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.
  739.  
  740.                       +o  XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____SSSSEEEELLLLFFFF-Attach the top side of the
  741.                          child to a position that is proportional to
  742.                          the current _y value of the child divided by
  743.                          the height of the Form.  This position is
  744.                          determined by the XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn and
  745.                          XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee resources.  XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn is
  746.                          set to a value proportional to the current _y
  747.                          value of the child divided by the height of
  748.                          the Form.
  749.  
  750.  
  751.           XXXXmmmmNNNNttttooooppppOOOOffffffffsssseeeetttt
  752.                     Specifies the constant offset between the top side
  753.                     of the child and the object to which it is
  754.                     attached.  The relationship established remains,
  755.                     regardless of any resizing operations that occur.
  756.                     When this resource is explicitly set, the value of
  757.                     XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllSSSSppppaaaacccciiiinnnngggg is ignored.
  758.  
  759.           XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn
  760.                     This resource is used to determine the position of
  761.                     the top side of the child when the child's
  762.                     XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN.  In
  763.                     this case the position of the top side of the
  764.                     child is relative to the top side of the Form and
  765.                     is a fraction of the height of the Form.  This
  766.                     fraction is the value of the child's
  767.                     XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn resource divided by the value of
  768.                     the Form's XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee.  For example, if the
  769.                     child's XXXXmmmmNNNNttttooooppppPPPPoooossssiiiittttiiiioooonnnn is 50, the Form's
  770.                     XXXXmmmmNNNNffffrrrraaaaccccttttiiiioooonnnnBBBBaaaasssseeee is 100, and the Form's height is
  771.                     200, the position of the top side of the child is
  772.                     100.
  773.  
  774.           XXXXmmmmNNNNttttooooppppWWWWiiiiddddggggeeeetttt
  775.                     Specifies the widget or gadget to which the top
  776.                     side of the child is attached.  This resource is
  777.                     used if XXXXmmmmNNNNttttooooppppAAAAttttttttaaaacccchhhhmmmmeeeennnntttt is set to either
  778.                     XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____WWWWIIIIDDDDGGGGEEEETTTT or XXXXmmmmAAAATTTTTTTTAAAACCCCHHHH____OOOOPPPPPPPPOOOOSSSSIIIITTTTEEEE____WWWWIIIIDDDDGGGGEEEETTTT.
  779.  
  780.                     A string-to-widget resource converter is
  781.                     automatically installed for use with this
  782.                     resource.  With this converter, the widget that is
  783.                     to be the value of the resource must exist at the
  784.                     time the widget that has the resource is created.
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 4/30/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  797.  
  798.  
  799.  
  800.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  801.           Form inherits behavior and resources from the following
  802.           superclasses.  For a complete description of each resource,
  803.           refer to the man page for that superclass.
  804.  
  805.                                XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  806.      NNNNaaaammmmeeee                  CCCCllllaaaassssssss                TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  807.      _________________________________________________________________________________
  808.      XmNallowOverlap       XmCAllowOverlap      Boolean          True           CSG
  809.      XmNautoUnmanage       XmCAutoUnmanage      Boolean          True           CG
  810.      XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic        CSG
  811.      XmNcancelButton       XmCWidget            Widget           NULL           SG
  812.      XmNdefaultButton      XmCWidget            Widget           NULL           SG
  813.      XmNdefaultPosition    XmCDefaultPosition   Boolean          True           CSG
  814.      XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic        CSG
  815.      XmNdialogTitle        XmCDialogTitle       XmString         NULL           CSG
  816.      XmNfocusCallback      XmCCallback          XtCallbackList   NULL           C
  817.      XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic        CSG
  818.      XmNmapCallback        XmCCallback          XtCallbackList   NULL           C
  819.      XmNmarginHeight       XmCMarginHeight      Dimension        0              CSG
  820.      XmNmarginWidth        XmCMarginWidth       Dimension        0              CSG
  821.      XmNnoResize           XmCNoResize          Boolean          False          CSG
  822.      XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY   CSG
  823.      XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT   CSG
  824.      XmNtextFontList       XmCTextFontList      XmFontList       dynamic        CSG
  825.      XmNtextTranslations   XmCTranslations      XtTranslations   NULL           C
  826.      XmNunmapCallback      XmCCallback          XtCallbackList   NULL           C
  827.  
  828.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  829.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  830.      _________________________________________________________________________________________________
  831.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  832.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  833.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  834.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  835.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  836.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  837.      XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
  838.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  839.      XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
  840.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  841.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  842.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  843.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  844.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  845.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  846.  
  847.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  848.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  849.      ______________________________________________________________________
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 4/30/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmFFFFoooorrrrmmmm((((3333XXXX))))
  863.  
  864.  
  865.  
  866.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  867.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  868.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  869.  
  870.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  871.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  872.      ______________________________________________________________________________________________________________
  873.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  874.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  875.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  876.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  877.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  878.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  879.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  880.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  881.      XmNdepth                        XmCDepth                        int              dynamic                CG
  882.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  883.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  884.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  885.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  886.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  887.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  888.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  889.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  890.      XmNx                            XmCPosition                     Position         0                      CSG
  891.      XmNy                            XmCPosition                     Position         0                      CSG
  892.  
  893.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  894.           XmForm inherits translations from XmBulletinBoard.
  895.  
  896.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  897.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))),
  898.           XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeFFFFoooorrrrmmmm, XXXXmmmmCCCCrrrreeeeaaaatttteeeeFFFFoooorrrrmmmmDDDDiiiiaaaalllloooogggg((((3333XXXX)))),
  899.           and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX)))).
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 4/30/98)
  922.  
  923.  
  924.  
  925.